Frappe Books GUI Importer

This is a Python-based GUI tool to help import bank statements (QIF, OFX, CSV) into a Frappe Books SQLite database.

It automatically creates double-entry transactions, mapping them to a bank account and a suspense/clearing account.

Features

Imports QIF, OFX, and CSV files.

Robust and flexible parsing for various date formats and file layouts.

Smart CSV "guessing" for one-column or two-column (debit/credit) amount formats.

Automatically detects your database schema (table names, columns) and adds missing columns (remark, voucherType, etc.) if needed.

Automatically creates a "Suspense Clearing" account if one is not found.

How to Use

Make sure you have parsers.py and importer_gui.py in the same folder.

Run the main application: python importer_gui.py

Click "Browse..." to select your Frappe Books .db file.

Click "Browse..." to select your bank statement (.qif, .ofx, .csv) file.

Select your Bank Account and your Suspense/Clearing Account from the dropdowns.

If using a CSV, map your columns.

Click "Import Transactions".

** !! LEGAL DISCLAIMER & WARNING !! **

This software is provided "AS IS", under the MIT License. Use at your ABSOLUTE OWN RISK.

This tool performs DIRECT MODIFICATION of your accounting database. The developer assumes NO LIABILITY for any data loss, data corruption, incorrect financial entries, or any other damage that may result from using this tool.

*** ALWAYS BACK UP YOUR .db FILE BEFORE USE. ***